home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / cli / GCd.lha / gcd / GCd.doc < prev    next >
Encoding:
Text File  |  1994-12-16  |  16.0 KB  |  386 lines
  1. /************************************************************************/
  2. /**     Informazioni su                                                **/
  3. /**                          GCd V2.3                                  **/
  4. /**                                                                    **/
  5. /**     un programma Shareware              scritto da Giulio Ceriola  **/
  6. /**                                                                    **/
  7. /**                                 ( Versione ultimata il 15-Dic-94 ) **/
  8. /************************************************************************/
  9.  
  10. Tale programma e' stato scritto da Giulio Ceriola ed e' liberamente
  11. distribuibile senza alcuna modifica e solo insieme alla relativa
  12. documentazione; consistente in:
  13.  
  14.                 GCd                File eseguibile del programma compatibile
  15.                                    con S.O. 2.x e superiori. Supporta due
  16.                                    lingue: italiano ed inglese.
  17.                 GCD_1.3            File eseguibile del programma compatibile
  18.                                    con i S.O. 1.2 e 1.3
  19.                 GCd.doc            Documentazione relativa al programma
  20.                                    valida per tutte e due le versioni
  21.                                    (questo file)
  22.                 GCd.doc.eng        Breve ma completa documentazione in
  23.                                    inglese.
  24.                 GCd_1.3.leggimi    Piccolo addendum per chi utilizza la
  25.                                    versione per i S.O. 1.2 e 1.3 !
  26.                 GCd_1.3.readme     Il precedente ... in inglese !
  27.           libs20/reqtools.library  La reqtools.library necessaria per il
  28.                                    funzionamento del programma (versione
  29.                                    S.O. 2.x). Da copiare nella directory
  30.                                    libs: se assente.
  31.           libs20/reqtools.library  Come sopra, ma per i S.O. 1.x.
  32.              libs13/arp.library    La arp.library necessaria per la versione
  33.                                    per S.O. 1.x
  34.  
  35.  
  36. Dato il tempo e lo sforzo per scrivere e testare il programma ho deciso che
  37. GCd e' un programma Shareware. Questo significa che se si utilizza regolarmente
  38. il programma, l'utente ha l'obbligo morale di mandare un contributo.
  39. Per questo vedere la sezione Shareware del presente manuale.
  40.  
  41. L'idea di creare il programma GCd e' partita dall'esigenza di gestire,
  42. tramite shell, l'elevato numero di directory del mio sistema, dopo
  43. l'aggiunta di un HD. C'era bisogno di un comando del genere cd che
  44. fosse capace di entrare in una directory semplicemente ricordando una
  45. perte di essa !
  46. Lo spunto vero e proprio me lo ha dato un altro programma che ha
  47. cercato di porre rimedio allo stesso problema ed e' DC di Peter Struijk.
  48.  
  49.  
  50. *****************
  51. CARATTERISTICHE *
  52. *****************
  53.  
  54. Il programma GCd e' capace di entrare in una directory in quattro modi.
  55. Il primo e' quello UGUALE al comando cd con la stessa sintassi e
  56. simbologia.
  57. Il secondo e' quello di entrare in una directory presente in quella
  58. attuale dello shell, mediante nome parziale, anche a partire da un'altra.
  59. Ad esempio, se la corrente directory e' Ram: ed in essa vi sono le
  60. directory T,ENV,TOOL; si puo' entrare in una di esse specificando solo
  61. un nome parziale (es. t,to ecc..)
  62. Il terzo e' quello di entrare in una QUALUNQUE directory presente in
  63. TUTTE le memorie di massa del sistema mediante nome parziale.
  64. Quest'ultimo uso e' possibile grazie alla presenza di un file, nella
  65. directory s: (o in quella Gcd: precedentemente assegnata dall'utente),
  66. chiamato Lista.gcd, che contiene le directory presenti nelle memorie di
  67. massa che devono essere "ricordate" dal comando Gcd.
  68. Questo file, od archivio, e' completamente ASCII ed eventualmente
  69. modificabile tramite comune text editor; ma il programma prevede anche
  70. delle opzioni per la sua creazione e manipolazione.
  71. Da ora in poi, per riferirmi a questo file usero' le dizioni LISTA o
  72. Lista.gcd; inoltre vengono usati indifferentemente i termini directory
  73. e path (percorso): volendo sempre indicare (un nome di) una directory con il
  74. suo path completo.
  75. Inoltre usero' la dicitura "directory" anziche' la traduzione italiana "cassetto".
  76. L'ultima maniera e' tramite requester.
  77.  
  78.  
  79. *********************************
  80. SINTASSI della LINEA di COMANDO *
  81. *********************************
  82.  
  83. Il comando GCd puo' essere utilizzato solo da CLI o Shell !
  84. La sua sintassi e':
  85.  
  86.             Gcd [argomento] [opzioni] [numero]
  87.  
  88.   UTILIZZI
  89.  
  90. Gcd, come il comando cd, puo' essere usato per vari scopi:
  91.  
  92. - Mostrare un sommario help                                     (1)
  93.   Sintassi: Gcd ?
  94.  
  95. - Mostrare la directory attuale                                 (2)     
  96.   Sintassi: Gcd
  97.  
  98. - Entrare nella(e) directory precedente(i) all'attuale          (3)
  99.   Sintassi: Gcd / (// ...)
  100.  
  101. - Entrare nella directory specificata INTERAMENTE nel comando   (4)
  102.   Sintassi: Gcd <nome+path nuova directory>
  103.  
  104. - Cercare una directory nella LISTA conservata e fra i path     (5)
  105.   presenti (attualmente accesibili) fornendone solo una parte
  106.   del nome
  107.   Sintassi: Gcd <nome parziale> [opzioni]
  108.  
  109. - Entrare in una directory e cercarne un'altra fra quelle da    (5a)
  110.   essa accessibili, fornendo L'INTERO path della prima (1o
  111.   livello) ed anche solo una parte del nome della seconda
  112.   Sintassi: Gcd <path.1o livello+nome parziale> [opzioni]
  113.  
  114. - Entrare in una directory scegliendola mediante un file-       (6)
  115.   requester.Esso permette anche la "multiselezione", ma
  116.   verra' considerata solo la prima directory selezionata.
  117.   Sintassi: Gcd !
  118.  
  119. - Modificare la LISTA conservata                                (7)
  120.   Sintassi: Gcd <nome device> opzioni
  121.   (opzioni obbligatorie !)
  122.  
  123.  
  124.  
  125.   OPZIONI
  126.  
  127. Tutte le opzioni devono essere raggruppate insieme e precedute dal simbolo
  128. "-", oltre ad essere il secondo argomento della linea comando.
  129. Esse riguardano le ultime due funzioni supportate, la ricerca e lo
  130. aggiornamento della LISTA.
  131.  
  132.  
  133. Opzioni riguardanti la funzione di ricerca  (5)
  134.  
  135.   Carattere        Funzione
  136.  
  137.       p            Esclude la ricerca fra i path della LISTA
  138.       e            Dice di scegliere, se presente, una directory che
  139.                    ha il nome uguale al <nome parziale> specificato
  140.       f            Scegli sempre e comunque la prima directory trovata
  141.  
  142.  
  143. Opzioni riguardanti la funzione di aggiornamento del database  (7)
  144.  
  145.   Carattere        Funzione
  146.  
  147.       s            Cancella la LISTA attuale e ne crea una contenente
  148.                    tutti i path del device specificato dal primo argomento
  149.       a            Come sopra, ma non cancella la LISTA, ma semplicemente
  150.                    aggiunge i path relativi al device specificato
  151.       u            Aggiorna nella LISTA, tutti i path del device specificato
  152.       n            Non controlla se il primo argomento specificato e' un device
  153.                    (nel caso si vogliano specificare device creati col comando
  154.                    assign)
  155.       o            Effettua tutte le precedenti operazioni cercando il file
  156.                    Lista.gcd nel device Gcd:
  157.  
  158.  
  159. NUMERO
  160.  
  161. Nel caso, specificando un nome parziale, si siano trovate molte directory,
  162. puo' risultare fastidioso ripetere il comando piu' volte sino a trovare quella
  163. esatta. In tal caso si puo' specificare un numero n, in maniera che, fra tutte
  164. le directory trovate verra' direttamente scelta quella n-esima.
  165. Si noti che non e' necessario ricordarsi il numero esatto, ma si potrebbe
  166. scegliere un n piu' piccolo si' da far partire poi Gcd da esso ed arrivare
  167. prima a quello gisto.
  168. Questa opzione funziona solo nel caso di ricerca fra le directory della LISTA.
  169.  
  170. *************************************
  171. FUNZIONAMENO DELLE VARIE OPERAZIONI *
  172. *************************************
  173.  
  174. Per le funzioni (1) (2) (3) (4) la sintassi e l'uso sono identici al
  175. comando Cd AmigaDOS.
  176.  
  177.  
  178. Per la funzioni (5), il programma COMUNQUE cerca di eseguire l'operazione
  179. (4), e SOLO in caso di fallimento, esegue la ricerca vera e propria.
  180. Il programma confronta l'argomento specificato con tutti i NOMI (e non
  181. i path) delle directory presenti nella LISTA.
  182.  
  183. Finito il confronto i casi sono tre:
  184.  
  185. -Ricerca riuscita ... solo un path trovato.
  186.  Il programma mostra qual e'; e poi cambia directory entrando nel path
  187.  trovato.
  188.  
  189. -Ricerca riuscita ... piu' di un path trovato.
  190.  In questo caso il programma segna su di un file in ENV: il nome parziale
  191.  fornito, il numero dei path trovati in tutto e ... il numero di quello
  192.  attuale. Infatti per scorrere fra i vari path trovati e' sufficiente
  193.  rispecificare lo stesso argomento <nome parziale> ed il programma passera'
  194.  al successivo. In ogni caso, quando Gcd informa del path trovato specifica
  195.  fra parentesi il numero di path in cui e' entrato e il numero totale dei
  196.  path trovati (x/y) !
  197.  Nel caso il device ENV: non sia assegnato o ci siano stati problemi a
  198.  leggere il file registrato, il programma entrera' nel primo path trovato.
  199.  Anche in questi casi, pero', l'opzione n funzionera' correttamente.
  200.  
  201. -Ricerca fallita ... nessun path trovato.
  202.  (od anche nel caso dell'opzione p specificata)
  203.  In questo caso il programma confronta tutti le directory direttamente
  204.  raggiungibili dalla directory attuale. Alla fine il comportamento sara'
  205.  simile al precedente:
  206.     
  207.      -Ricerca riuscita ... solo un path trovato.
  208.       Il programma mostra qual e'; e poi cambia directory entrando nel
  209.       path trovato.
  210.  
  211.      -Ricerca riuscita ... piu' di un path trovato.
  212.       In questo caso il programma chiedera' di sceglierne uno, mostrandoli
  213.       uno alla volta ... In questo caso premendo la <space bar> si passa al
  214.       path successivo, per sceglierne uno bastera' premere qualche altro
  215.       tasto.
  216.  
  217.      -Ricerca fallita ... nessun path trovato
  218.       Viene visualizzato un messaggio di errore di directory non trovata
  219.       ed il programma termina.
  220.  
  221.  
  222. Per la funzione (5a) il programma separa le due parti dell'argomento
  223. ricavando la directory del 1o livello mediante l'ultimo modificatore
  224. (carattere ':' o '/'). Dopodiche cerca di entrare nella prima e se vi
  225. riesce esegue la ricerca fra i percorsi "presenti" e si comporta come
  226. specificato nella seconda parte del punto (5).
  227. Se il programma non riesce ad entrare nella directory del 1o livello un
  228. adeguato messaggio di errore verra' visualizzato.
  229.  
  230.  
  231. Per la funzione (7)
  232. Il programma aggiorna, in maniera diversa a seconda delle opzioni, il
  233. piccolo database LISTA inserendovi i path del device specificato.
  234. Bisogna precisare che questa funzione viene attivata proprio dalle
  235. opzioni a,u,s; in mancanza di queste verranno eseguite le operazioni (2)
  236. (3), (4) e (5) !
  237.  
  238.  
  239. Per funzionare il programma si conserva nella directory s: un file di
  240. nome gcd.cfg. Esso contiene alcuni settaggi per il programma; per adesso
  241. non e' modificabile dall'utente ... ma le future versioni lo permetteranno.
  242.  
  243. *********************************
  244. SITUAZIONI DI ERRORE - CONSIGLI *
  245. *********************************
  246.  
  247. Le situazioni di errore ed il comportamento di GCd possono essere le seguenti:
  248.  
  249. - Fallimento di tutte le operazioni <-> Directory non trovata
  250. - Fallimento o problemi nel leggere e/o scrivere l'archivio LISTA
  251.   (irrimediabile)
  252. - Fallimento nel leggere e/o scrivere il file Gcd.ENV nella directory
  253.   logica ENV:
  254.   (il prg continua, ma non e' possibile gestire piu' directory trovate)
  255. - Fallimento di apertura delle risorse
  256.   (irrimediabile)
  257. - Errore nello specificare le opzioni
  258.   (il prg non parte)
  259.  
  260. ATTENZIONE ad usare l'opzione n. Essa non e' concettualmente compatibile
  261. con l'idea del programma, ma e' stato messa per completezza, per soddisfare
  262. eventuali "sfizi" !
  263.  
  264. ****ATTENZIONE****
  265. Nel caso si desiderasse editare 'a mano' il file Lista.gcd invece che
  266. manipolarlo mediante il prg stesso, ci si DEVE RICORDARE di AGGIUNGERE
  267. IN CODA al file un LF (o altro carattere) dopo l'ultimo path ... pena
  268. un impietoso GURU !!
  269.  
  270. ****************
  271. COMPATIBILITA' *
  272. ****************
  273.  
  274. GCd e' fornito in due versioni.
  275.  
  276. Una compatibile con sistemi 2.x e superiori, localizzata (nel senso
  277. che mostra i messaggi in una certa lingua, non che usa un catalogo).
  278. Se non e' supportata la locale viene scelto l'inglese.
  279.  
  280. Un'altra compatibile con i sistemi 1.2 ed 1.3. Qui, invece, il
  281. linguaggio supportato e' solo l'inglese, ma e' possibile forzare quello
  282. italiano tramite l'opzione -i presente solo in questa versione del programma.
  283.  
  284. GCd ha bisogno della reqtools.library (che deve essere presente nella
  285. directory libs: di sistema) per la selezione di una directory tramite
  286. requester (6).
  287. Inoltre la versione per S.O. 1.x necessita della arp.library per poter
  288. usare le wildcards.
  289.  
  290. ***********
  291. SHAREWARE *
  292. ***********
  293.  
  294. Dato il tempo e lo sforzo per scrivere e testare il programma ho deciso
  295. che GCd e' un programma Shareware. Questo significa che se si utilizza
  296. regolarmente il programma, l'utente ha l'obbligo morale di mandare un
  297. contributo.
  298.  
  299. Il programma non registrato ora ha alcune limitazioni nel finzionamento, ma
  300. non piu' limite di utilizzo come nelle precedenti versioni.
  301. The caratteristiche disabilitate sono la scelta tramite requester e l'uso
  302. delle wildcards.
  303.  
  304. Il contributo richiesto e' di 10000 Lit. per gli utenti che vivono in Italia,
  305. o di 9$ (USD) per gli atri (a causa della differenza delle tariffe postali).
  306.  
  307. Per il pagamento sono consigliabili i seguenti modi:
  308.  
  309.         - vaglia postale (eventualmente internazionale)
  310.         - contanti
  311.  
  312. o qualsiasi altra forma sia ritenuta piu' congeniale,
  313.  
  314. a:
  315.            Giulio Ceriola
  316.            v. C.Rosalba 38/a
  317.            70124 BARI ITALY
  318. (nel caso interessasse il mio numero di tel. e' 080-513311)
  319.  
  320. E' consigliabile che mi venga spedita una lettera.
  321. Bisogna specificare il proprio indirizzo e, facoltativamente, il sistema
  322. operativo e l'uso o meno di HD. Se si puo' essere raggiunti atraverso
  323. qualche rete telematica, prego specificare il prprio "indirizzo".
  324.  
  325. Una volta registrati, verra' spedita l'ultim(issim)a versione del
  326. programma piu' la una key.
  327.  
  328. *********************
  329. VERSIONI PRECEDENTI *
  330. *********************
  331.  
  332. 1.0     Prima versione rilasciata
  333. 1.1     Modificata struttura del programma: eliminati fastidiosi piccoli
  334.         bug nel riconoscimento della linea di comando con opzioni.
  335.         Velocizzate operazioni di gestione della Lista.
  336.         Ottimizzato il prg in dimensioni.  (non rilasciata)
  337. 1.6     Modificato display della scelta di piu' directory trovate fra
  338.         quelle presenti.
  339.         Aggiunta scelta numero di directory da assumere fra quelle trovate
  340.         nella Lista.
  341.         Adesso l'opzione -e funziona correttamente.
  342.         Attivavta possibilita' di tenere il file Lista.gcd nalla directory
  343.         s: od in Gcd:.
  344.         Aggiunta la possibilita' di specificare un percorso da cui cominciare
  345.         la ricerca dei path "presenti".
  346. 2.0     Inserita la possibilita' di entrare in una directory selezionandola
  347.         mediante un requester, e con questo modificata profondamente la
  348.         struttura del programma.
  349.         Verione per S.O. 1.x ancora supportata.
  350. 2.2     Aggiunta, per la versione registrata, l'uso delle wildcards per la
  351.         ricerca della directory solo per la versione per SO 2.x.
  352.         Esteso l'uso delle wildcards anche alla versione per SO 1.x con
  353.         l'utilizzo dell'Arp library.
  354. 2.3     Cambiata la limitazione shareware. Adesso gli unici limiti sono la
  355.         disabilitazione dell'opzione ! e delle wildcards.
  356.  
  357. *******************************
  358. SVILUPPI SUGGERIMENTI ESTERNI *
  359. *******************************
  360.  
  361. Per le successive versioni penso di abbandonare la stesura anche per
  362. S.O. 1.x; concentrandomi solo su quella 2.x e 3.0; a meno di eventuali
  363. registrazioni per quella versione.
  364.  
  365. Questi gli sviluppi in cantiere:  &&&
  366.  
  367. - Esclusione ricerca fra path nel file LISTA
  368. - Scelta dir anche con altri "indizi" riguardo l'intero path
  369. - Per la scelta dei path dalla lista, possibilita' di fare come per i
  370.   path presenti in caso di errore, o se specificato tramite opzione
  371.  
  372. Ogni suggerimento, critica, richiesta e' bene accetta.
  373. Per contattarmi potete farlo via Fido ed Amiganet agli indirizzi:
  374.  
  375.               Fidonet   2:335/704.4@fidonet.org
  376.               Amiganet 39:102/602.4@amiganet.ftn
  377.               RPGNet   96:390/1.4@rpgnet.ftn
  378.               VNet     46:1390/11.4@vnet.ftn
  379.  
  380. o collegandovi alla BBS
  381.  
  382.               Prometheus      tel. ++39-80-5515278
  383.                               su modem USR HST 21600.
  384.  
  385. e lasciando un messaggio al Cosysop ( IO :-) ).
  386.